// +----------------------------------------------------------------------
// | 蓝鲸云企业级开发框架 [ 赋能开发者，助力企业发展 ]
// +----------------------------------------------------------------------
// | 版权所有 2020~2025 ${author}
// +----------------------------------------------------------------------
// | Licensed Apache-2.0 【蓝鲸云】并不是自由软件，未经许可禁止去掉相关版权
// +----------------------------------------------------------------------
// | 官方网站: https://www.lanjingcloud.vip
// +----------------------------------------------------------------------
// | 软件作者: @${author} 团队荣誉出品
// +----------------------------------------------------------------------
// | 版权和免责声明:
// | 本团队对该软件框架产品拥有知识产权（包括但不限于商标权、专利权、著作权、商业秘密等）
// | 均受到相关法律法规的保护，任何个人、组织和单位不得在未经本团队书面授权的情况下对所授权
// | 软件框架产品本身申请相关的知识产权，被授权主体务必妥善保管官方所授权的软件产品源码，禁
// | 止以任何形式对外泄露(包括但不限于分享、开源、网络平台),禁止用于任何违法、侵害他人合法
// | 权益等恶意的行为，禁止用于任何违反我国法律法规的一切项目研发，任何个人、组织和单位用于
// | 项目研发而产生的任何意外、疏忽、合约毁坏、诽谤、版权或知识产权侵犯及其造成的损失 (包括
// | 但不限于直接、间接、附带或衍生的损失等)，本团队不承担任何法律责任，本软件框架禁止任何
// | 单位、组织、个人用于任何违法、侵害他人合法利益等恶意的行为，如有发现违规、违法的犯罪行
// | 为，本团队将无条件配合公安机关调查取证同时保留一切以法律手段起诉的权利，本软件框架只能
// | 用于公司和个人内部的法律所允许的合法合规的软件产品研发，详细声明内容请阅读《框架免责声
// | 明》附件；
// +----------------------------------------------------------------------

package ${packageName}.feign;

import com.lanjing.core.constant.ServiceNameConstants;
import com.lanjing.core.utils.R;
import ${packageName}.dto.${entity?lower_case}.${table.entityName}AddDTO;
import ${packageName}.dto.${entity?lower_case}.${table.entityName}ListDTO;
import ${packageName}.dto.${entity?lower_case}.${table.entityName}PageDTO;
import ${packageName}.dto.${entity?lower_case}.${table.entityName}UpdateDTO;
import ${packageName}.entity.${entity};
import ${packageName}.vo.${entity?lower_case}.${table.entityName}InfoVO;
import ${packageName}.vo.${entity?lower_case}.${table.entityName}ListVO;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.cloud.openfeign.SpringQueryMap;
import org.springframework.web.bind.annotation.*;

import java.util.List;

/**
 * <p>
 * ${table.comment!}远程调用服务
 * </p>
 *
 * @author ${author}
 * @since ${date}
 */
@FeignClient(contextId = "remote${entity}Service", value = ServiceNameConstants.SYSTEM_SERVICE)
public interface ${modelPrefix}${entity}${modelSuffix} {

    /**
     * 查询分页列表
     *
     * @param ${entity?lower_case}PageDTO 查询条件
     * @return 返回结果
     */
    @GetMapping("/${entity?lower_case}/page")
    R page(@SpringQueryMap ${entity}PageDTO ${entity?lower_case}PageDTO);

    /**
     * 查询数据列表
     *
     * @param ${entity?lower_case}ListDTO 查询条件
     * @return 返回结果
     */
    @GetMapping("/${entity?lower_case}/list")
    List<${entity}ListVO> getList(@SpringQueryMap ${entity}ListDTO ${entity?lower_case}ListDTO);

    /**
     * 根据ID查询信息
     *
     * @param id ${table.comment!}ID
     * @return 返回结果
     */
    @GetMapping("/${entity?lower_case}/info/{id}")
    ${entity} getInfo(@PathVariable("id") Integer id);

    /**
     * 根据ID查询详情
     *
     * @param id ${table.comment!}ID
     * @return 返回结果
     */
    @GetMapping("/${entity?lower_case}/detail/{id}")
    ${entity}InfoVO getDetail(@PathVariable("id") Integer id);

    /**
     * 添加${table.comment!}
     *
     * @param ${entity?lower_case}AddDTO 参数
     * @return 返回结果
     */
    @PostMapping("/${entity?lower_case}/add")
    R add(@RequestBody ${entity}AddDTO ${entity?lower_case}AddDTO);

    /**
     * 更新${table.comment!}
     *
     * @param ${entity?lower_case}UpdateDTO 参数
     * @return 返回结果
     */
    @PutMapping("/${entity?lower_case}/update")
    R update(@RequestBody ${entity}UpdateDTO ${entity?lower_case}UpdateDTO);

    /**
     * 删除${table.comment!}
     *
     * @param id 任务ID
     * @return 返回结果
     */
    @DeleteMapping("/${entity?lower_case}/delete/{id}")
    R delete(@PathVariable("id") Integer id);

    /**
     * 批量删除${table.comment!}
     *
     * @param idList ${table.comment!}ID
     * @return 返回结果
     */
    @DeleteMapping("/${entity?lower_case}/batchDelete")
    R batchDelete(@RequestBody List<Integer> idList);

}
